home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)TA / (A)TAK.ADF / Arp_v1.04 / MANUAL.ARC / Atol < prev    next >
Text File  |  1987-11-19  |  1KB  |  67 lines
  1.  
  2.  
  3.  
  4.      Atol(31.0)          ARP Programmers Manual        Atol(31.0)
  5.  
  6.  
  7.  
  8.      NAME
  9.       Atol -- Convert ascii    string to long int.
  10.  
  11.      SYNOPSIS
  12.       intval = Atol("string")
  13.         d0           a0
  14.  
  15.      FUNCTION
  16.       Convert "string" to a    long integer.  This function will skip
  17.       leading whitespace. This function returns an error if    a
  18.       non-whitespace non-digit is encountered during processing.
  19.  
  20.      INPUTS
  21.            string -- pointer ascii string, which may be null
  22.              terminated or whitespace terminated.
  23.              The digits may    have leading whitespace.
  24.  
  25.      RESULT
  26.       If a non-numeric is encountered during processing (other
  27.       than whitespace or a null terminator), this function will
  28.       return with the Z flag SET, and the offending    character in
  29.       d0.  If calling from 'C', the    binding    routine    for this
  30.       function will    place the error    value ERRBADINT    in the global
  31.       long Errno if    there is an error.  Errno is not cleared on a
  32.       succesful return.
  33.  
  34.      BUGS
  35.       Values which cannot be represented as    a 32bit    integer    will
  36.       not cause an error.
  37.  
  38.      AUTHOR
  39.       SDB
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/19/87)
  64.  
  65.  
  66.  
  67.